2. EL 9
  3. nvme-stas
  4. stacctl(1)

Scroll to navigation

STACCTL(1) STACCTL(1)

NAME

stacctl - STorage Appliance Connector (STAC) utility program

SYNOPSIS

stacctl [OPTIONS...] {COMMAND} [OPTIONS...]

DESCRIPTION

stacctl is a tool that can be used to communicate with the stacd(8) daemon to retrieve operational data.

COMMANDS

The following commands are understood:

tron

Trace ON. Enable code tracing, which is to say that lots of debug information will be printed to the syslog (e.g. systemd-journal).

troff

Trace OFF. Disable code tracing.

status

Show runtime status information.

ls

Show the list of I/O controllers. This will list all the I/O controllers configured in stacd.conf(5) as well as those discovered by the stafd(8) daemon.

OPTIONS

The following options are understood:

-h, --help

Print the help text and exit.

--version

Print the version string and exit.

-d, --detailed

Print additional details.

EXIT STATUS

On success, 0 is returned; otherwise, a non-zero failure code is returned.

EXAMPLES

Example 1. List I/O controllers

$ stacctl ls --detailed
[{'connect attempts': 0,


  'device': 'nvme1',


  'host-iface': '',


  'host-traddr': '',


  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',


  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',


  'model': 'Linux',


  'retry connect timer': '60.0s [off]',


  'serial': '8d22fa96da912fb13f5a',


  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aedead',


  'traddr': '::1',


  'transport': 'tcp',


  'trsvcid': '8009'},


 {'connect attempts': 0,


  'device': 'nvme2',


  'host-iface': '',


  'host-traddr': '',


  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',


  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',


  'model': 'Linux',


  'retry connect timer': '60.0s [off]',


  'serial': 'a9987ae2fd173d100fd0',


  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aebeef',


  'traddr': '::1',


  'transport': 'tcp',


  'trsvcid': '8009'},


 {'connect attempts': 0,


  'device': 'nvme3',


  'host-iface': '',


  'host-traddr': '',


  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',


  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',


  'model': 'Linux',


  'retry connect timer': '60.0s [off]',


  'serial': '13e122f1a8122bed5a8d',


  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34ae8e28',


  'traddr': '::1',


  'transport': 'tcp',


  'trsvcid': '8009'}]

Example 2. Disable tracing

$ stacctl troff

Example 3.  Show stacd(8) operational status.

$ stacctl status
{'config soak timer': '1.5s [off]',


 'controllers': [{'connect attempts': 0,


                  'device': 'nvme1',


                  'host-iface': '',


                  'host-traddr': '',


                  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',


                  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',


                  'model': 'Linux',


                  'retry connect timer': '60.0s [off]',


                  'serial': '8d22fa96da912fb13f5a',


                  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aedead',


                  'traddr': '::1',


                  'transport': 'tcp',


                  'trsvcid': '8009'},


                 {'connect attempts': 0,


                  'device': 'nvme2',


                  'host-iface': '',


                  'host-traddr': '',


                  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',


                  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',


                  'model': 'Linux',


                  'retry connect timer': '60.0s [off]',


                  'serial': 'a9987ae2fd173d100fd0',


                  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34aebeef',


                  'traddr': '::1',


                  'transport': 'tcp',


                  'trsvcid': '8009'},


                 {'connect attempts': 0,


                  'device': 'nvme3',


                  'host-iface': '',


                  'host-traddr': '',


                  'hostid': '3e518ec3-72ec-46a5-a603-2510e3140e29',


                  'hostnqn': 'nqn.2014-08.org.nvmexpress:uuid:13730573-e8d7-446e-81f6-042a497846d5',


                  'model': 'Linux',


                  'retry connect timer': '60.0s [off]',


                  'serial': '13e122f1a8122bed5a8d',


                  'subsysnqn': 'nqn.1988-11.com.dell:PowerSANxxx:01:20210225100113-454f73093ceb4847a7bdfc6e34ae8e28',


                  'traddr': '::1',


                  'transport': 'tcp',


                  'trsvcid': '8009'}],


 'log-level': 'DEBUG',


 'tron': True}

SEE ALSO

stacd.conf(5), stacd(8) ()

nvme-stas 2.2.1